home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
edit
/
xvidoc.zip
/
XVI.LST
< prev
Wrap
File List
|
1992-07-28
|
17KB
|
529 lines
XVI(1) USER COMMANDS XVI(1)
NAME
xvi - multi-file text editor
SYNOPSIS
xvi { -s _p_a_r_a_m_e_t_e_r-_a_s_s_i_g_n_m_e_n_t } [ -t _t_a_g | +_n_u_m_b_e_r |
+/_p_a_t_t_e_r_n ] { _f_i_l_e_n_a_m_e ... }
DESCRIPTION
Xvi (pronounced _e_c_k_s-_v_e_e-_e_y_e) is a free, portable, multi-
window implementation of the popular vi(1) editor. It has
some useful enhancements, although, as described below, not
all of vi's features have been implemented yet, and some
things work differently from vi.
OPTIONS
The following command-line options are available:
-s _p_a_r_a_m_e_t_e_r-_a_s_s_i_g_n_m_e_n_t
Set the value of the specified parameter at startup.
The assignment has the same form as when given as an
editor command, i.e:
_n_a_m_e=_s_t_r_i_n_g
for string parameters
_n_a_m_e=_n_u_m_b_e_r
for numeric parameters
_n_a_m_e to turn a Boolean parameter on
no_n_a_m_e
to turn a Boolean parameter off
-t _t_a_g
Edit the file containing the definition specified as
_t_a_g, at the start of the definition (as per vi).
+_n_u_m_b_e_r
Go to the specified line number of the file being
edited.
+/_p_a_t_t_e_r_n
Go to the first occurrence of the specified _p_a_t_t_e_r_n
within the file being edited.
The -r command line option is not supported.
ENHANCEMENTS
Multiple buffers and windows
A _b_u_f_f_e_r is the internal object which holds a file in
memory, while a _w_i_n_d_o_w is an area of the screen which shows
part of a buffer. Every window references a buffer, even if
Unix Last change: 19/6/1992 1
XVI(1) USER COMMANDS XVI(1)
no file is being edited. The following commands are
available for operating on buffers and windows:
:buffer
create a new buffer in a new window; can be followed by
a filename, which will be edited in the new buffer.
:split
create a new window on to the current buffer by
splitting the current window in half. The two
resulting windows are similar to _v_i_e_w_p_o_r_t_s on to a
single editing buffer, in that changes made in one
window are reflected in the other one.
:close
close the current window; will also close the buffer if
this is the last window on to it.
:x / ZZ
close only the current window. If the window is the
only one on to the buffer, the buffer will be closed as
well, writing it first if it is modified.
g move to the next window.
^W increase the size of the current window (may be given a
numeric prefix, default is one line).
^T decrease the size of the current window (may be given a
numeric prefix, default is one line).
^O make the current window as large as possible.
^] as for vi, but create a new buffer window if
appropriate (and if autosplit allows).
Note that the :quit command quits out of the editor, not out
of a window. The :close command is thus the equivalent of
:quit for windows. There is no equivalent of :x or ZZ for
the whole editor; these have been hijacked for operations on
windows.
The numeric autosplit parameter specifies the maximum number
of buffer windows that will be created automatically
whenever you either edit more than one file, or use tags to
edit a different file.
Undo works per buffer, as do marks; yank/put and redo (the .
command) work over all buffers, i.e. you can delete from one
buffer and put the text into a different buffer.
Unix Last change: 19/6/1992 2
XVI(1) USER COMMANDS XVI(1)
File preservation
Rather than use vi's Unix-specific method for preservation,
xvi does periodic preservation of all files currently being
edited into temporary files in the same directory. It tries
to do this when you aren't typing, so that you won't notice
the short delay when the temporary file is written out.
Obviously, only changed files are preserved in this way, and
the temporary file is removed once the real file has been
successfully written.
8-bit character support
Characters with the top bit set are accepted by xvi, but it
is not yet possible to have null ('\0') bytes in a file
buffer. How characters are displayed can be controlled by
the cchars and mchars parameters, which, if set, cause
control and meta-characters respectively to be output
unchanged; otherwise they are shown as sequences of
printable characters.
Tabs are normally displayed as a series of spaces of the
appropriate length (according to the tabstops parameter);
setting list mode will cause them to be displayed as control
characters, as will unsetting the tabs parameter. How the
tab character is displayed is then under the control of the
cchars parameter.
You can use the ^_ (control-underscore) command to flip the
top bit of the character the cursor is on. This may be
useful on systems where it is otherwise impossible to enter
8-bit characters.
File formats
Xvi can read and write text files in non-Unix formats. The
current format is given by the value of the format
parameter, which may be set to "unix", "msdos", etc. To see
a list of available formats, type
:se fmt=?
Extended regular expressions
vi's magic parameter is superseded by the regextype
parameter, which can take the following values:
tags only ^ and $ are significant (used for tags)
grep like grep(1), but with \< and \> added
egrep
like egrep(1), but with \< and \> added
The default is grep.
Unix Last change: 19/6/1992 3
XVI(1) USER COMMANDS XVI(1)
Note that it is still possible to set or unset magic as in
vi; this will simply result in regextype being set as
appropriate.
The sections and paragraphs parameters define egrep-style
patterns to search for, rather than vi's simplistic (and
troff-dependent) character pairs.
Improved replace mode
The R command acts more intelligently when you press return
- it leaves the rest of the current line alone, and just
starts replacing text on the next line, starting at the
screen column where you first typed R.
Command re-execution
As well as the normal named (conjugate) buffers, and the
default one (named @), there exist several extra ones named
:, /, ? and !, which contain the last command lines typed to
each of the given commands. So for instance, @: will re-
execute the last ex command, or you can insert it into your
buffer, edit it and then re-execute it (e.g. with dd@@).
Jumpscroll
When multiple windows are used, xvi normally has to be able
to scroll individual windows without scrolling the whole
screen. This can be very inefficient on terminals without
scrolling regions, so the jumpscroll parameter is provided
to control the editor's scrolling behaviour. It can be set
to one of:
off When the cursor moves outside a window's boundaries,
and the new position is near enough, the window will
scroll to the new position.
on When the cursor moves outside a window's boundaries,
the window will always jump to the new position.
auto A window will scroll only if it can do so efficiently;
otherwise it will jump.
The default value is auto.
On ISA-type systems which have memory-map